=== KineticCopy - AI Copywriting for WordPress ===
Contributors: nexusnoir
Tags: ai, copywriting, content, brand voice, schema
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 8.0
Stable tag: 1.7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI copywriting for WordPress. Bring your own Anthropic API key. Brand voice profiling from your existing content, 43 content types, Brain AI Assistant, AEO/GEO schema, Breakdance integration.

== Description ==

**KineticCopy learns how you write. Then writes like you.**

Most AI writing tools produce generic content that sounds like everyone else. KineticCopy starts by scanning up to 200 of your existing posts, extracting your sentence rhythm, vocabulary patterns, tone markers, and paragraph structure. The result is a Writing DNA profile that is entirely yours - no other site's content trains it, no other site uses it.

Every piece of content you generate is shaped by that profile, so your new posts sound like a natural continuation of your existing work, not an AI-generated intrusion.

= What you get =

**Brand Voice Profiling (Writing DNA)**
Scan your published posts to extract your unique voice. Sentence length patterns, favourite words, tone signals, paragraph structure - all captured and applied to future generations. Free plan scans 10 posts and includes 5 DNA-enhanced generations per month; premium scans 200 posts with unlimited DNA generations.

**43 Content Types**
Blog posts (5 lengths), headlines, calls to action, product descriptions, about pages, FAQ pages, social posts, email bodies, newsletters, how-to guides, landing pages, sales pages, white papers, case studies, LinkedIn posts, email sequences, press releases, testimonials, taglines, content briefs, content calendars, and more. Free plan includes 10 types.

**AEO/GEO - Answer Engine and Generative Engine Optimisation**
Auto-generates JSON-LD schema markup (FAQ, HowTo, Article, Product, Review) so your content is structured for AI search engines - Google AI Overviews, ChatGPT, Perplexity - not just traditional Google. AEO/GEO is included in the free plan.

**Brain AI Assistant**
A context-aware AI chat sidebar inside WordPress admin. Brain knows your brand context, the current post you are editing, and your writing DNA. Ask it to sharpen a section, suggest a better hook, check your AEO angle, or explain why a paragraph is not landing. Premium feature.

**Tone Blending (up to 4 tones)**
Choose from 24 tone presets (Professional, Bold, Conversational, Empathetic, Witty, etc.) and blend up to 4 at once for content that hits exactly the right register. Free plan includes Professional and Conversational plus any tones autodiscovered from your writing DNA.

**Persona Targeting**
24 audience personas covering demographics, psychographics, and pain points. Pin a persona to a generation so the AI tailors vocabulary, examples, and framing for that specific reader. Premium feature.

**Rewrite with Tone**
Select any post, pick a saved tone template, and get a full rewrite with a before/after diff preview. Accept, reject, or edit. WordPress saves a revision automatically before any change is applied. Premium feature.

**Breakdance Native Element**
A custom element inside the Breakdance visual builder with prompt, format, and word count controls. One-click copy to clipboard. Also works with Gutenberg, Classic Editor, Elementor, Divi, Bricks - core features live in WP admin, not tied to any single builder. Premium feature.

**Content Library**
Save prompts and generated content, organise into folders, re-run any saved prompt in the Studio with one click. Premium feature.

**KineticLaunch Integration (optional)**
Connected to your KineticLaunch brand strategy platform. Your positioning, messaging pillars, elevator pitch, pricing intelligence, and competitor context are automatically injected into every generation. Calendar briefs from KineticLaunch appear inside KineticCopy automatically. Requires a KineticLaunch account.

**Bring Your Own API Key (BYOK)**
You use your own Anthropic Claude API key. No per-generation credits to buy, no AI usage fees on top of your subscription. Pay Anthropic directly at your own usage rate. Your key is stored with AES-256 encryption.

**7-Day Premium Trial**
Every new install gets a full 7-day premium trial with no signup required. All 43 content types, Brain, Calendar Sync, Breakdance element, and the full tone palette are active from the first minute. After day 7, the plugin drops to the free floor until you add a license key.

**Free Floor (no license required, no expiry)**

- 10 content types: Blog Post, Headline, CTA, Product Description, About Page, FAQ Page, Social Post, Email Body, Newsletter, How-To Guide
- 3-4 tones: Professional, Conversational, plus any autodiscovered from your writing DNA
- AEO/GEO content optimisation (always included, free forever)
- Writing DNA scan (10 posts) + 5 DNA-enhanced generations per month
- Core Copywriting Studio UI

= Perfect for =
- Content creators who want their AI-written posts to sound like them
- Marketing teams that need fast, brand-consistent copy across 43 formats
- Agencies managing brand voice for multiple clients
- Breakdance users who want AI content generation in-context inside the builder
- SEO practitioners who need structured schema markup for AI search engines

= Security =
API keys are stored with AES-256 encryption. License keys are validated by your own KineticLaunch server with a 72-hour offline cache. Rate limiting (50 requests/hour) prevents runaway API usage. Prompt injection detection is built in.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate the plugin through the Plugins menu
3. Your 7-day premium trial starts automatically - no signup required
4. Go to KineticCopy - Settings - API Keys and enter your Anthropic API key (get one at https://platform.claude.com/)
5. Go to KineticCopy - Site Intelligence and click "Scan Site Now" to build your Writing DNA profile
6. Open the Copywriting Studio and generate your first piece of content

To activate a premium license after your trial, go to KineticCopy - Settings - License and enter your key.

== Frequently Asked Questions ==

= Do I need my own API key? =

Yes. KineticCopy uses a Bring Your Own Key (BYOK) model - you connect your own Anthropic Claude API key. This means you pay Anthropic directly for your actual usage and there are no per-generation fees from KineticCopy on top of your plan. You can get a key at https://platform.claude.com/

= What content types are free? =

The free plan includes 10 content types with no expiry: Blog Post (short), Headline, Call to Action, Product Description, About Page, FAQ Page, Social Post, Email Body, Newsletter, and How-To Guide. AEO/GEO schema markup is also always included. Premium unlocks all 43 formats.

= What is the 7-day trial? =

Every new install gets a 7-day premium trial with no account required. All features are active from the first minute. After day 7, if you do not add a license key, the plugin automatically drops to the free floor. The trial cannot be reset by deactivating and reactivating the plugin - it is tied to the first activation timestamp stored in your database.

= How does Writing DNA work? =

KineticCopy scans your published posts and pages, extracts patterns in your sentence length, vocabulary, tone signals, and paragraph structure, then sends that profile to the API as context for every generation. The scan runs on your server and the profile is stored in your own database. Nothing is shared externally. Free plan scans 10 posts and includes 5 DNA-enhanced generations per month; premium scans 200 posts with unlimited DNA generations.

= Which page builders does it work with? =

KineticCopy works with any WordPress theme or builder. There is a native custom element inside Breakdance (premium feature). Core features - the Copywriting Studio, Brain, Content Library - live in WordPress admin and are builder-independent. Gutenberg, Classic Editor, Elementor, Divi, and Bricks all work fine with the Studio.

= Is my API key secure? =

Yes. Your API key is encrypted with AES-256 before being stored in the database. The encryption key is stored separately in wp-config.php, following WordPress security best practices.

= What happens when my license expires? =

You will get an admin notice when your license expires. After expiry there is a 7-day grace period during which all premium features remain active. After the grace period, the plugin automatically drops to the free floor until you renew.

== Screenshots ==

1. Copywriting Studio - content type dropdown, tone grid, persona selector, and prompt field
2. Writing DNA - site intelligence scan showing detected brand voice and recommended tones
3. Brain AI Assistant - contextual chat sidebar with BrainWave animation
4. Content Library - saved snippets organised into folders with run-again button
5. Settings - License tab with tier badge and activation management
6. Settings - Upgrade tab with plan comparison and pricing
7. Breakdance custom element - in-builder content generation panel

== Changelog ==

= 1.7.0 =
* 7-day premium trial on first activation - no signup required, cannot be reset by deactivating
* Free floor: 10 content types, 3-4 tones, 10-post DNA scan + 5 DNA generations/mo, AEO/GEO always included
* Content type guard on both front-end UI and server-side AJAX handler
* Brain AI Assistant, Content Library, Tone Templates, Rewrite with Tone, Persona Targeting, Breakdance element gated to premium with upgrade nudges
* Auto-updater for licensed users: hooks into WordPress update system, one-click update from our server
* Update server endpoint at copy.kineticbrain.ai validates license before serving ZIP download
* Consistent upgrade nudge component (kc-upgrade-nudge) with accessible styling
* DNA scan capped at 10 posts for free users, 200 for premium

= 1.6.0 =
* Licensing system with tier detection and 7-day grace period on expiry
* 4 tiers: Solo (1 site), Studio (3), Agency (25), Enterprise (unlimited) - all features in every tier
* Upgrade tab with direct payment links for all plan options
* Calendar Sync: bidirectional status sync between WordPress and KineticLaunch calendar
* 43 content types (added: SEO Blog Post, Thought Leadership, How-To Guide, LinkedIn Post)
* Agency activation management UI in License settings tab

= 1.5.0 =
* Rewrite with Tone - full post rewrite with diff preview and WP revision snapshot
* CSS design token system (40+ --kc-* variables)
* Schema copy button and auto-inject option in Studio

= 1.4.0 =
* Brain AI Assistant with BrainWave animation and contextual greeting
* KineticBrand full context injection
* Perplexity fact-check layer (optional)
* Rate limiting and prompt injection detection

= 1.1.0 - 1.2.3 =
* Site Intelligence Engine for brand voice learning
* AEO/GEO optimisation
* Fact-checking mode
* Multi-tone selection (up to 4 tones)

= 1.0.0 =
* Initial release
* AI-powered copywriting with Anthropic Claude API (BYOK)
* Tone blending with up to 4 tones from 24 presets
* Audience persona management
* Breakdance integration with native custom element
* Research capabilities (Google, Bing, Brave, DuckDuckGo)
* AES-256 encrypted API key storage

== Upgrade Notice ==

= 1.7.0 =
Adds 7-day premium trial for new users, free floor with 10 content types and AEO/GEO, and auto-updates for licensed users. Existing licensed sites are unaffected.

= 1.6.0 =
Adds licensing system, Calendar Sync, and 43 content types total. Add a license key in Settings to unlock all premium features permanently.
